home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Commodities / LockIt / LockIt.DOC < prev    next >
Text File  |  1996-09-26  |  14KB  |  358 lines
  1.  
  2. LOCK IT version 2.1. FREEWARE.
  3.  
  4. FREEWARE means: LockIt may only be distributed by Andreas Linnemann, Tom
  5. Kuhlenkamp and Rainer Klinke. Written permissions for distribution can be
  6. issued by these persons. This permission is hereby granted for Fred Fish's
  7. "Amiga Lib Disk".
  8.  
  9. A simple data protection utility by Andreas Linnemann.
  10.  
  11.                                    MANUAL
  12.                                    ======
  13.  
  14.    Contents
  15.   ----------
  16.  
  17. 1. General instructions
  18.  
  19. 1.1 What can LockIt be used for?
  20. 1.2 System requirements
  21. 1.3 Hardware incompatibilities
  22. 1.4 Software incompatibilities
  23.  
  24.  
  25. 2. Installation
  26.  
  27. 2.1 On Workbench
  28. 2.2 On CLI
  29.  
  30.  
  31. 3. Controls
  32.  
  33. 3.1 Opening the Contol Window
  34. 3.2 The list of objects
  35. 3.3 Locking an object
  36. 3.4 Unlocking an object
  37. 3.5 Saving the list
  38. 3.6 Anything else?
  39.  
  40. 1. General instructions
  41.  
  42. 1.1 What can LockIt be used for?
  43.  
  44. Well, "lock" means closing something so that no one except the one who has
  45. a "key" can access it. But what can be locked on a computer? Files, for
  46. example, or drawers containing files.
  47. The sense of this action is that there are definitely Amiga users who keep
  48. files on their harddisk, which should not be accessible for any person
  49. (e.g. children or friends who hang at your computer without your knowing
  50. it). Conclusion: We simply LOCK these drawers. Finished. Everything ok.
  51. The "key" consists of a password which ONLY YOU should know. It is indeed
  52. quite difficult to use different keys except keyboard keys at PC's.
  53.  
  54.  
  55. 1.2 System requirements
  56.  
  57. As one requirement you first need an Amiga computer. Whether 500, 1000,
  58. 2000 or 3000 or anything else is not important. BUT:
  59.  
  60. ----====****>>>> LOCKIT REQUIRES KICKSTART 2.0 OR HIGHER! <<<<****====----
  61.  
  62. The amount of memory is of less importance, as LockIt is quite short and
  63. does not need a large amount of memory.
  64.  
  65.  
  66. 1.3 Hardware incompatibilities
  67.  
  68. Hardware Incompatibilities are not known (yet).
  69. LockIt is being successfully used on the following systems:
  70. A2000, 1MB Chip,CBM2630(4MB),Oktagon2008+ 105MB QuantumLPS,Flickerfixer
  71. A500Plus, 1MB Chip,2MB Fast,GVP SerieII+52MB Quantum LPS
  72. A500Plus, 2MB Chip,Oktagon500+FujitsuM2611S(42MB)
  73.  
  74.  
  75. 1.4 Software incompatibilities
  76.  
  77. Problems with any software are not known except of programs trying to
  78. access locked dirs/files (e.g. Hard Disk backup systems).
  79.  
  80.  
  81. 2. Installation
  82.  
  83. 2.1 On Workbench
  84.  
  85. First take care that LockIt is run at every system start. Simply copy the
  86. program and its icon into your WBStartup drawer on your workbench
  87. disk/partition. After that click onto its icon one time. Call
  88. "Information..." from the Icon menu. You can use the following tool types:
  89.  
  90. DONOTWAIT --- Use this if you definitely use LockIt in "WBStartup"
  91.               (unless you want to use ONLYINSTALL=YES)
  92.  
  93. ONLYINSTALL --- LockIt only installs the protection for the objects in the
  94.   =<YES/NO>     saved list and removes itself from memory after that. If
  95.                 you start LockIt a second time, LockIt is installed in
  96.                 memory like usual. This feature is only recommended for
  97.                 users with lack of memory.
  98.  
  99. === CAUTION!! === Never use both DONOTWAIT AND ONLYINSTALL=YES, as this
  100.                   could cause system crashes!
  101.  
  102. EDITINIT=<type> --- Here you can specify the way to open the control
  103.                     window.
  104.    <type>=APPICON - LockIt puts its own icon onto the Workbench. Double-
  105.                     clicking opens the control window.
  106.    <type>=TOOLSENTRY - LockIt adds the entry "LockIt" in your Workbench
  107.                        "Tools" menu. Selecting opens the control window.
  108.    <type>=BOTH - Both Icon and Tools-Entry are created.
  109.    <type>=NONE - Neither Icon or Tools-Entry is created.
  110.  
  111. ICON_X=<value> --- The horizontal position of the LockIt icon can be
  112.                    specified here.
  113. ICON_Y=<value> --- The vertical position of the LockIt icon.
  114.                    If no values are specified here or if both values
  115.                    are zero, the icon is put anywhere if there is enough
  116.                    space, mostly at the left side.
  117.  
  118. SCREEN=<type> --- If <type> is equal to "WBENCH", the control window will
  119.                   appear on the Workbench screen (or the current Public
  120.                   Screen). If <type> is equal to "ACTIVE", the control
  121.                   window will be opened on the currently active screen
  122.                   (e.g. Deluxe Paint screen). Open any new screen and then
  123.                   perform the LockIt key combination (e.g. Left-Amiga-L).
  124.                   LockIt will open its window on this screen.
  125.                   CAUTION: Don't close the screen before closing the
  126.                   control window. If you do, you will definitely cause a
  127.                   system crash!
  128.  
  129. CONFIG=<path> --- For <path> you can type the name of the LockIt config
  130.                   file. Default path is "S:LockIt.config".
  131.  
  132. CX_POPUP   --- If this tool type is set to "YES", LockIt will open its
  133. =<YES/NO>      control window at once if started.
  134.  
  135. CX_POPKEY=<key> --- For <key> you can enter the contol key sequence which
  136.                     will cause LockIt's control window to be opened.
  137.                     Default key is "LCommand l" (left Amiga key and "L" at
  138.                     the same time). The expressions for all the key
  139.                     combinations can be found in your Workbench manual.
  140.                     Already noticed that LockIt is indeed a Commodity??
  141.  
  142. CX_PRIORITY=<value> --- <value> contains LockIt's Commodity priority. If
  143.                         two commodities have the same HotKey, the one
  144.                         with the higher priority will be preferred.
  145.                         Default value is zero.
  146.  
  147. Instructions for entering tooltypes can be found in your Workbench manual.
  148.  
  149.  
  150. 2.2 On CLI
  151.  
  152. LockIt should be started from Startup-Sequence or User-Startup in the S-
  153. Directory. As there is no icon, the tooltypes must follow the program call
  154. as parameters. Try it, copy LockIt into the C-Directory and enter in CLI:
  155.  
  156. C:LockIt EDITINIT=APPICON ICON_X=60 ICON_Y=20 "CX_POPKEY=CONTROL F1"
  157.  
  158. This command will put the LockIt icon at (60/20) onto the workbench and
  159. makes LockIt accessible by the key combination "CONTROL F1". Don't forget
  160. the quotes! They are necessary, if a parameter contains white spaces, in
  161. order to prevent misunderstandings.
  162.  
  163. Now edit your User-Startup (e.g. with MEMACS) and add a line calling
  164. LockIt including its parameters
  165.  
  166. LockIt does not need "run", as it detaches from CLI automatically and
  167. does not stop the CLI activities.
  168.  
  169.  
  170. 3. Controls
  171.  
  172. Normally, LockIt is mouse-controlled. Strings are self-evidently entered
  173. by keyboard. The buttons can be clicked with keyboard commands, too. Press
  174. the underlined letter in/beside the buttons on your keyboard. The cursor
  175. keys (up & down) can be used for scrolling through the list entries.
  176.  
  177.  
  178. 3.1 Opening the control window
  179.  
  180. There are four possibilities for opening the control window:
  181. 1. Double-clicking the Application icon on the workbench
  182. 2. Selecting "LockIt" in the Tools-Menu
  183. 3. Performing "LCommand l" or the key combination specified in "CX_POPKEY"
  184. 4. Starting LockIt a second time. This function was built in because there
  185.    is no reason to start LockIt two times except editing the list.
  186.  
  187. According to EDITINIT, the number of possibilities can be reduced, but
  188. Point 3 and 4 are always available.
  189.  
  190.  
  191. 3.2 The list of objects
  192.  
  193. There is a listin the upper region of the control window. The list is
  194. divided into "Object" (name of the Object) and "Status" which can be
  195. "locked" or "unlocked". You can scroll the list with the bar on the right
  196. side or with the little arrows. The cursor keyss (up and down) are also
  197. suitable for scrolling through the list.
  198.  
  199.  
  200. 3.3 Locking an object
  201.  
  202. To protect an object, press the "Add" button first. An entry is added in
  203. the list and "Edit" is selected for this entry. The Edit window asks you
  204. for the Object name. This name will be found in the list later on. After
  205. that the object itself must be specified as a complete path onto a file or
  206. a drawer. You can alternatively get your mouse and press "Select". An ASL-
  207. Filerequester will appear and will allow you to select your object in a
  208. comfortable way. If a file is selected and no Object name has been entered
  209. yet, the file name will be copied to the Object name. Please ensure that
  210. the COMPLETE path is entered (e.g. "DH1:Data/Beckertext/Letters" and not
  211. only "Letters").
  212.  
  213. If you have successfully entered your object, you are to enter a password
  214. now. Please do not mix up upper and lower case letters! Ensure that you
  215. are alone. Do not forget the password! Write it down, but please do not
  216. put the sheet beside your computer.
  217.  
  218. If a Lock can not be performed (e.g. wrongly written path), an error
  219. message will appear. Leaving the Edit-Window with "OK" will not be
  220. possible until the Lock can be performed. "Cancel" will always work.
  221.  
  222. PLEASE PAY ATTENTION: As LockIt is a Commodity, you can hide or kill it
  223. with the Workbench-Tool "Exchange". Please do not hide/kill LockIt if the
  224. Edit window is open. If you do, the window will be closed and the
  225. modifications are LOST! Please leave the Edit window with "OK" and use
  226. "Exchange" to your heart's content.
  227.  
  228. The protection itself can be activated now. Click on the Cycle-Gadget
  229. next to "Status" or press "t" on your keyboard. The Cycle-Gadget and the
  230. Status of the current object will change to "Locked". Try to open the
  231. object, it is not possible any more.
  232.  
  233. To say it again: LockIt is very different to the Workbech-Command "Lock"!
  234. LockIt does not only protect data of being deleted or written, it's a
  235. read protect as well! Without LockIt the object is not accessible unless
  236. a reset is performed. If LockIt is called after every System reset,
  237. practically permanent (but NO absolute!!) protection is granted.
  238.  
  239.  
  240. 3.4 Unlocking an object
  241.  
  242. To unlock an object, select the object in the list at first, so that it
  243. is visible below the list. Now switch the Status to "unlocked". LockIt
  244. asks you to type the password now. After successfully entering the pass-
  245. word, the object is really unlocked.
  246.  
  247. 3.5 Saving the list
  248.  
  249. Never forget to save the list. The path given with "CONFIG" is used, or
  250. if no path is specified, "S:LockIt.config". The Objectnames, paths,
  251. passwords and states are saved. If you start LockIt the next time, the
  252. file is read and the "locked" objects are locked indeed.
  253.  
  254.  
  255. 3.6 Anything else?
  256.  
  257. "Delete" deletes the current object, "Edit" makes it possible to change
  258. the object name path and password after typing the old password.
  259.  
  260. At the bottom there are a few more buttons. "Hide" hides the control
  261. window, "About" opens a small information requester. The close gadget
  262. is the same as "Hide". "Quit" removes LockIt from memory, but locked
  263. objects remain locked.
  264.  
  265. Consider the following: If a path is active to your object (e.g.
  266. SYS:fonts/ to FONTS:), LockIt cannot install a protection. It is also
  267. impossible if the object has been opened on the Workbench or if it is
  268. somehow "in use". LockIt will tell you this with an error message.
  269.  
  270. LockIt is a Commodity. You can hide or kill or do anything with it with
  271. the Workbench-Tool "Exchange". But condsider the warning in 3.3.
  272.  
  273. ...and now a few MOST IMPORTANT things:
  274.  
  275. 1. LockIt does NOT provide absolute protection against data misuse.
  276.    Professional users may be able to deactivate the protection. Most
  277.    critical data should therefore be copied to disks and deleted from
  278.    harddisk. The disks should be kept safe.
  279. 2. Although the passwords are encoded before being saved, please to not
  280.    use words which you use to use in Mailboxes or anywhere else because
  281.    it may be possible to decode the configuration file.
  282. 3. UNLOCK ALL objects before starting a harddisk-backup. ALFBackup
  283.    crashed when trying to access locked files/dirs.
  284.  
  285.  
  286. So, that's it. If you have questions, bug reports or simply want to say
  287. hello, please contact the author of the program or the author of this
  288. manual (that's me). Please excuse my strange English as we use to speak
  289. German in Germany.
  290.  
  291.  
  292. LockIt 2.1. Finished in August, 1992.
  293.  
  294.      Program-Author,  Tests                    Manual, Icon, Tests
  295.      ----------------------                    ---------------------
  296.      Andreas Linnemann                         Tom Kuhlenkamp
  297.      Ringstraße 26                             Ritzenberger Weg 18
  298.      W-2817 Dörverden-Barme                    W-2811 Blender
  299.      Germany                                   Germany
  300.      Phone (Ger) 04234/1294                    Phone (Ger) 04233/448
  301.  
  302.  
  303. Created for and sponsored by Rainer Klinke.
  304.  
  305.  
  306. History
  307. -------
  308. V1.0     CLI-Tool without intuition surface, only one object, full of
  309.          errors, needed two programs ("LockIt" and "Unlock")
  310.  
  311. V1.1     Most bugs fixed, only for Kickstart 1.3
  312.  
  313. V2.0     More objects, difficult user surface, slow, still 2 programs
  314.          ("LockItInstall" and "LockIt"), full of errors
  315.  
  316. V2.01-   New surface, safe and (nearly) bug-free, application icon,
  317. V2.08    tools-entry, commodity, ASL-Filerequester
  318.  
  319. V2.09    Quicker Window refresh, better Commodity-handling. Bug in string
  320.          gadgets and ASL-Requester fixed. Blocking of unused windows
  321.  
  322. V2.1a    Auto-detach, CLI-Parameters, internal icon, better error-
  323.          handling. Window gets used to screenfont size
  324.  
  325. V2.1b    Clean quitting in case of a program bug, bug in OnlyInstall-
  326.          routine fixed which was visible quite seldom. Repeatedly changed
  327.          the save format (sorry). Clean handling if started again. Real
  328.          version-handling added. Quicker (better Stack handling). Opening
  329.          window if started twice. Bug in window-blocking-routine fixed.
  330.          Checking for Lock already in Edit-Window. Bug at "Add" and
  331.          "Delete" fixed, memory was not freed.
  332.  
  333. V2.1     Minor bugs fixed, first publication
  334.  
  335. Neither the author nor anyone else takes guarantee for damages caused by
  336. the usage of LockIt. If bugs should become visible which could not be
  337. removed in spite of the long test phase, the author is grateful for any
  338. bug reports. Please deliver an exact bug report and do not write something
  339. like "LockIt seems to be so strangely slow" or something like this.
  340.  
  341. Thank you for using LockIt.
  342.  
  343.  
  344.  
  345.               ///
  346.              ///            Only
  347.             ///
  348.            ///          A  M  I  G  A
  349.           ///
  350. \\\      ///              makes  it
  351.  \\\    ///
  352.   \\\  ///                possible!
  353.    \\\///
  354.     \///
  355.  
  356.  
  357.  
  358.